Skip to content

buzz-acp: add structured MCP server configuration - #4164

Open
wolfyy970 wants to merge 4 commits into
block:mainfrom
wolfyy970:feat/acp-structured-mcp-servers
Open

buzz-acp: add structured MCP server configuration#4164
wolfyy970 wants to merge 4 commits into
block:mainfrom
wolfyy970:feat/acp-structured-mcp-servers

Conversation

@wolfyy970

@wolfyy970 wolfyy970 commented Aug 1, 2026

Copy link
Copy Markdown

Summary

This gives Buzz one versioned MCP launch document instead of one opaque command per agent. buzz-acp accepts multiple named stdio servers, preserves their order, arguments and environment, and sends the same list through every ACP session. The existing BUZZ_ACP_MCP_COMMAND path remains the first compatibility input.

#4271 can add HTTP to the same document. Desktop and Project Connections can resolve approved tools into it without adding another runtime format.

Boundary

This document is resolved launch input. Personas, templates and Projects remain authoring state and are not passed directly to a runtime.

The adapter still inherits the harness environment, so this is explicit configuration rather than process isolation. On Unix, config files must be absolute, regular, owner-owned and owner-only. MCP values are structurally redacted from logs, observer events, diagnostics and returned adapter errors without changing the values sent to the agent.

Validation

  • cargo test -p buzz-core -p buzz-acp -p buzz-agent --no-fail-fast
  • cargo clippy -p buzz-core -p buzz-acp -p buzz-agent --all-targets -- -D warnings
  • cargo fmt --all -- --check
  • Real-process regression: two MCP children initialize, list and execute tools across two fresh ACP sessions

Fixes #4154.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f9e32d5848

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread crates/buzz-acp/src/acp.rs

wolfyy970 commented Aug 2, 2026

Copy link
Copy Markdown
Author

#4301 now describes the broader portable-agent lifecycle using Buzz's existing agent, template, connection, version and snapshot concepts. This PR remains the first narrow slice: structured, named MCP configuration in buzz-acp.

Copy link
Copy Markdown
Author

@tlongwell-block @wpfleger96, @custard-pirate and I agree on the MCP split: #4164 owns the versioned document and stdio transport; #4271 adds HTTP to that schema. #4480 can then use the same document for live changes instead of adding a third config format.

That leaves Buzz with one MCP configuration surface and one compatibility input. Could one of you confirm this ownership split? If so, I will keep #4164 at that boundary and help adapt #4271 to it.

Copy link
Copy Markdown
Author

@tlongwell-block @wpfleger96, I have replaced the repair history with four reviewable commits on current main. #4271 is already adapting HTTP to this document, so review of the shared config boundary would unblock both transports.

Local tests, Clippy, formatting and the real two-server, two-session proof are green. CI is running.

Signed-off-by: KC <79471844+wolfyy970@users.noreply.github.com>
Signed-off-by: KC <79471844+wolfyy970@users.noreply.github.com>
Signed-off-by: KC <79471844+wolfyy970@users.noreply.github.com>
Signed-off-by: KC <79471844+wolfyy970@users.noreply.github.com>
@wolfyy970
wolfyy970 force-pushed the feat/acp-structured-mcp-servers branch from 780561c to 0945861 Compare August 6, 2026 10:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

buzz-acp: structured MCP server configuration with explicit credential scoping

1 participant